home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / tvagentt.zip / HOWTO.TXT < prev    next >
Text File  |  1996-08-19  |  20KB  |  384 lines
  1. -------------------------------------------------------------------------
  2.   TV Agent --  HOW TO FOR SYSOPS           8/19/96
  3.  
  4. 1. Receiving TVLIST*.*
  5. 2. $2 credit for distributing TV listings
  6. 3. Distributing TVLIST*.*
  7. 4. TV Agent Demo
  8. 5. Your personal use of TV Agent
  9.  
  10.  
  11.  
  12. 1. Receiving TVLIST*.*
  13.  
  14. TV listings for use with TV Agent are sent every day in the Planet
  15. Connect datastream. Before the first transmission of the Fido mail,
  16. and before the Fido mail repeats, three files TVLIST??.ARC are
  17. transmitted. Sometimes the Fido mail is repeated a third time, and in
  18. that case it is preceded by eight TVLIST??.ARC files, which is the
  19. set for the whole current week.
  20.  
  21. The TVLIST*.* land in the directory you have specified in the line in
  22. RULEBASE.CFG with grp 7. By default that line is
  23.  
  24. :rulebase, *,   7,   *,      *,    *,    *,  disk, C:\TV/,                *
  25.                                                    ^^^^^
  26. You can change the path to another drive and directory (keep the
  27. trailing "/".)
  28.  
  29. If you use TV Agent yourself AND you pass the datafiles on to others
  30. you will want to change rulebase grp 7 to routinely send the data
  31. files to a different directory. C:\TV is the default directory where
  32. your personal copy of TVAGENT.EXE was installed when you installed
  33. your Planet Connect software, and you do NOT want TVAGENT.EXE to run
  34. in the directory with your only copy of TVLIST*.* before you have
  35. distributed the TVLIST*.*.
  36.  
  37. Two of the new TVLIST??.* files you get each morning are listings
  38. files, where the ?? shows the day of the month. One file is for
  39. tomorrow ("fresh" listings, containing changes the programmer
  40. announced yesterday) and one is for 6 days later ("advance" listings.)
  41. If today is the 9th, the file containing freshly updated listings for
  42. tomorrow will be called TVLIST10.ARC. The other file contains
  43. "advance" listings for the day one week from today, TVLIST16.ARC. On
  44. the 15th you will get a slightly larger, fresher TVLIST16.ARC, and the
  45. advance TVLIST22.ARC. The filenames are reused, so if you never delete
  46. them your directory will soon have 31 files, TVLIST01.ARC thru
  47. TVLIST31.ARC, consuming about 9 megabytes.
  48.  
  49. The small TVLISTTK.ARC file sent each day can be unzipped to find two
  50. TIC files, for instance TV960710.TIC and TV960716.TIC, which match the
  51. two new listings files sent that day. The TIC parameter "Replaces"
  52. appears in some of the TIC files to eliminate obsolete listings files
  53. -- for instance the TIC for the advance TVLIST07.ARC will say
  54. "Replaces TVLIST29.ARC" because by the time you have received advance
  55. listings for the 7th, the file for the 29th is definitely obsolete.
  56. The "Replaces" parameter is not used to delete listings for the first
  57. 8 days of the month because those can be used with the TV Agent demo
  58. on any day.
  59.  
  60. If you didn't get the TVLIST*.* due to errors or your local problem,
  61. you can freq them from 1:3615/50 or ftp from ftp.planetc.com. If there
  62. was a problem getting the TV listings uplinked on time, the files may
  63. already be available at Planet Connect. If you have not received one
  64. of the expected TVLIST*.* files by the time the PCUSENET downlink
  65. starts, you may not want to wait for the next repeat -- go ahead and
  66. freq or ftp them. The filedate should be today, for the two files you
  67. expected to get today. TV Agent works best when users look at FRESH
  68. listings for tomorrow, so users will appreciate it if you replace the
  69. advance listings with the fresh listings which have the same file name
  70. as soon as possible.
  71.  
  72.  
  73.  
  74. 2. ------- $2 Credit for Planet Connect sites supplying TVLIST*.ARC
  75.  
  76. When a TV Agent subscriber identifies a Planet Connect site as his
  77. source for TVLIST*.* files, that Planet Connect site gets a $2 credit
  78. on their next PC renewal. The PC site gets another $2 credit when the
  79. TV Agent subscription is renewed. There is no limit on the credit
  80. available; if you supply listings to enough TV Agent subscribers to
  81. more than pay for your Planet Connect subscription, Planet Systems
  82. will pay YOU at your renewal time. The PC site gets the credit even if
  83. the user gets the listings from another BBS which ultimately got the
  84. listings from the PC site.
  85.  
  86. Make sure your TV Agent users know they should identify your PC site
  87. when they subscribe to TV Agent so Planet Systems can direct the
  88. credit to the right place. If they don't mention any PC site, you can
  89. still get the credit by calling me and claiming them by name. Also
  90. call me if you'd like to check the status of your credits and which
  91. subscribers have said they get listings from you.
  92.  
  93. If you're hubbing the listings thru other BBSs the end users may not
  94. know who you are, but you can announce yourself and tell them who
  95. supplies their listings by inserting a notice into the listings. Write
  96. an ASCII file called "ANNOUNCE.TXT", with a maximum line length of 74.
  97. The first line will be used as a heading. The file could be up to 32K
  98. long but I hope you don't have that much to say. Then insert it into
  99. a TVLIST*.* occasionally. First check that the listing file does not
  100. already contain an ANNOUNCE.TXT; I put one in when channels change
  101. names or locations etc and you don't want to mess up one of my rare
  102. announcements.
  103.  
  104. PKUNZIP -t TVLIST17.ARC
  105.  
  106. will tell you if there already is an ANNOUNCE.TXT in TVLIST17.
  107. Actually you better check each one of the current listings, because if
  108. the TVLISTdd.ARC where I put an ANNOUNCE.TXT gets unzipped BEFORE the
  109. TVLISTdd.ARC where you put one, my announcement gets overwritten.
  110.  
  111. PKZIP TVLIST17.ARC ANNOUNCE.TXT     will insert your announcement.
  112.  
  113. Don't do it often enough to annoy your callers; the presence of an
  114. announcement  prevents their TV Agent from immediately jumping to the
  115. current listings. They will have to see the first ~20 lines on any day
  116. they decompress a TVLIST*.* that contained an ANNOUNCE.TXT. They can
  117. then read the whole thing, or print it; then it is automatically
  118. deleted. Of course you screw up the TIC CRC when you insert a file.
  119.  
  120.  
  121.  
  122. 3. ---------------  Distributing TVLIST*.*
  123.  
  124. Planet Connect sites and others can distribute the TVLIST*.ARC files
  125. for use with TV Agent to callers or to other BBSs. A FILE_ID.DIZ is
  126. included in each TVLIST*.ARC which identifies the day the listings are
  127. for and whether the listings are fresh or advance. It also includes a
  128. short description of TV Agent and tells how to subscribe.
  129.  
  130. The extension .ARC is still used, for irrelevant historical reasons.
  131. If you find the extension is confusing you can rename them
  132. TVLIST??.ZIP. TV Agent users are not supposed to unzip them, and any
  133. file extension besides ZIP might help prevent complaints from users
  134. who try to unzip them. Renaming them TVLIST??.AGT might be less
  135. confusing. TVAGENT.EXE will PKUNZIP TVLIST*.* so it does not care
  136. what extension you use. However, the .TIC files that are zipped into
  137. TVLISTTK.ARC refer to the .ARC extension, so if you rename them do it
  138. after you're thru with the TICs.
  139.  
  140. TV Agent subscribers will probably call you EVERY DAY and download a 290k
  141. file. They need to have those fresh listings for tomorrow to take best
  142. advantage of TV Agent. If they don't mind missing a few changes in
  143. schedule and additional episode details, they may use the advance
  144. listings instead (those are still fresher than weekly paper guides which
  145. have to be printed and mailed.)
  146.  
  147. Any time they call (after you've received the TVLIST*.* in the Planet
  148. Connect datastream) they can download fresh listings for today and
  149. tomorrow and advance listings for the next six days. Some callers may
  150. call only once a week and download fresh listings for the next day,
  151. and advance listings for the rest of the week.
  152.  
  153. People who take their TV listings seriously will probably call you
  154. daily and download TWO files, the same two TVLIST*.* that you got from
  155. satellite. That way if they don't connect one day, they will still
  156. have the advance listings for the fresh day they missed.
  157.  
  158. This last strategy is supported by a door program written by Pab
  159. Sungenis. If you want to use it, freq TVDOOR.ZIP from him at 1:266/73
  160. or from Planet Connect 1:3615/50. Or, se